02 환경 설정 및 설치 | ✅ 편저: 코담 운영자

Django 튜토리얼 #2 - 환경 설정 및 설치

">유튜브

---

🔗 소스

---

1. Python 설치

• python.org에서 최신 버전의 Python 다운로드 (예: 3.12.3)

• 설치 후 아래 명령어로 설치 확인:

python --version
pip --version

✅ pip은 Python 설치 시 자동 포함되며 외부 라이브러리 설치에 사용됨

---

2. Pipenv 기반 가상환경 구성

Django는 프로젝트마다 독립된 가상환경에서 설치·실행하는 것이 권장됨

✅ 1. Pipenv 설치

pip install pipenv

✅ 2. Pipfile 기반 가상환경 생성 및 패키지 설치

pipenv install

• Pipfile과 Pipfile.lock이 존재하는 디렉토리에서 실행해야 함

• 해당 파일들을 기준으로 자동으로 가상환경을 만들고 필요한 패키지를 설치함

✅ Pipfile 예시

[[source]]
url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"

[packages]
django = "*"

[dev-packages]

[requires]
python_version = "3.10"

• [[source]]: 패키지를 받을 저장소 (보통 PyPI)

• [packages]: 설치할 일반 패키지 목록 (여기선 Django 최신 버전)

• [dev-packages]: 개발용 패키지 (예: flake8 등)

• [requires]: Python 최소 버전 명시

✅ Pipfile.lock 설명

• Pipfile.lock은 Pipfile에 명시된 패키지들의 정확한 버전과 해시값을 기록해줌

• 팀 프로젝트나 배포 환경에서 동일한 의존성을 보장할 수 있음

✅ 3. 가상환경 진입

pipenv shell

• 이 명령으로 Pipenv 가상환경 안으로 진입하며, 이후 모든 Python 및 Django 명령은 이 환경 안에서 실행

✅ 4. 스크립트 실행 예시

pipenv shell              # 가상환경 진입
python manage.py runserver  # Django 개발 서버 실행

또는 가상환경 진입 없이 직접 실행하려면:

pipenv run python manage.py runserver

✅ 정리

• Pipfile을 실행시키는 개념이 아니라, Pipenv가 Pipfile을 기반으로 실행환경을 구성

• Pipfile이 있는 디렉토리에서 명령을 실행해야 정확하게 작동함

• 기존 requirements.txt보다 더 정밀하고 명확한 의존성 관리 가능

---

3. Django 설치 확인

django-admin --version   # 예: 5.0.4

---

4. Django 프로젝트 생성

django-admin startproject myproject

생성 디렉토리 구조 예시

myproject/
├── manage.py
├── db.sqlite3
├── Pipfile
├── Pipfile.lock
├── myapp/ (앱 생성 후 추가됨)
└── myproject/
    ├── __init__.py
    ├── asgi.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

---

5. 주요 파일 및 폴더 설명

• manage.py: Django 프로젝트 명령 실행 진입점

• db.sqlite3: 기본 SQLite 데이터베이스 파일

📁 myapp

• models.py: 데이터베이스 모델 정의

• views.py: 요청 처리 로직

• admin.py: 관리자 페이지 설정

• apps.py: 앱 구성 정보

• migrations/: 데이터베이스 마이그레이션 기록

📁 myproject

• settings.py: 전체 프로젝트 설정 (앱 등록, DB 등)

• urls.py: URL 라우팅 설정

• asgi.py/wsgi.py: 서버 연동용 파일

---

6. 앱 생성 및 서버 실행

✅ 앱 생성

python manage.py startapp myapp

✅ 개발 서버 실행

python manage.py runserver

• 실행 후 브라우저에서 http://127.0.0.1:8000 접속 → Django 환영 페이지가 보이면 성공

---

다음 강의 예고

• Django 앱 등록 및 settings.py 설정 방법